---
title: 'Getting Started'
section: 'help'
tags: ['introduction', 'setup']
order: 1
---

# Getting Started

Welcome! Let's get you set up with Codebuff, the AI coding agent.

## Installation

Install Codebuff globally using npm:

```bash
  npm install -g codebuff
```

## Basic Usage

Start using Codebuff in your project directory:

```bash
  codebuff
```

Or, start a new project with one of our [starter templates](https://github.com/CodebuffAI/codebuff-community/tree/main/starter-templates):

```bash
  codebuff --create nextjs project-name
```

That's it! Codebuff is now ready to help you with your coding tasks.

## Troubleshooting Install

If you run into issues during installation:

1. **Check Node Version**

   - Make sure you have [Node version 18+](https://nodejs.org/en/download) installed
   - Verify your version: `node --version`

2. **Permission Issues**

   - On Mac/Linux: Try `sudo npm install -g codebuff`
   - On Windows: Run command prompt as administrator

3. **Still Having Problems?**
   - Try reinstalling Node using [nvm or fnm](https://nodejs.org/en/download)
   - Run the Codebuff install command again

If you're still experiencing issues, check out our [Troubleshooting](/docs/advanced#troubleshooting) guide or join our [Discord community](https://codebuff.com/discord)!
